home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / util4 / cy.lha / cy.doc < prev   
Text File  |  1996-01-10  |  6KB  |  145 lines
  1. Short:    an ARexx program to manage CyberCron 1.15
  2. Uploader: rick@emma.panam.wimsey.com
  3. Author:   rick@emma.panam.wimsey.com
  4. Type:     util/misc
  5. Replaces: util/misc/cy1.0.lha
  6. Version:  1.1
  7. Requires: ARexx, CyberCron 1.15
  8.  
  9. I. Using from the command line
  10.  
  11.    cy is an ARexx program to manage Chris Wichura's cron
  12.    utility, CyberCron. The command line options allow you to
  13.    start, stop, suspend and resume CyberCron's operation. You
  14.    can also list all the queued events and list the event(s)
  15.    that are queued to run next.
  16.  
  17.    If you have ARexx running, 'cy ?' should output something
  18.    like this:
  19.  
  20.         -e  edit crontab [C:ed -sticky SYS:S/CronTab]
  21.         -b  begin CyberCron [ME:Tools/CyberCron]     
  22.         -q  quit (kill) CyberCron                    
  23.         -s  suspend                                  
  24.         -r  resume                                   
  25.         -n  next event(s) to execute                 
  26.         -l  list all events, sorted
  27.         -L  list all events, raw
  28.         -g  toggle logfile
  29.         editor  = C:ed -sticky      
  30.         logfile = LOGS:CyberCron.log
  31.         crontab = SYS:S/CronTab
  32.  
  33.    This shows the command line switches and current program paths.
  34.    You'll have to set the paths for your system under USER SETTABLE
  35.    OPTIONS at the start of the program (see III.)
  36.  
  37.  
  38. II. Using from the window
  39.  
  40.    Typing just 'cy' with no options starts up a window where you
  41.    can page through queued events and manipulate them. You can
  42.    add, delete, purge rexx events, open/close the logfile,
  43.    suspend/resume CyberCron's operation.
  44.  
  45.    (This will make more sense after you start cy.  Sorry for the
  46.    messyness.)
  47.  
  48.    The header looks like this:
  49.  
  50. 12:53:46  08/01/96      -- cy -- [CyberCron 1.5]                    p1 of 1 
  51.   ^          ^                          ^   
  52.   |          |                          |
  53.   |         current date               CyberCron version
  54.   |
  55.  current time (updated whenever a key is pressed)
  56.  
  57.    The events look like this:
  58.  
  59. 17:02          MailPan :MAILUSER postmaster :OBEYQUEUE u   
  60. 17:02          docron :MAILUSER postmaster :OBEYQUEUE u    
  61. 17:02          :PRI -1 uucp:c/trimnews -h 2880 :OBEYQUEUE u
  62. 07:40 09/01/96 GetNews -puv :OBEYQUEUE u          
  63. 16:05 10/01/96 :NOLOG bitch got your lotto ticket?
  64.   ^     ^       ^
  65.   |     |      the cron event
  66.   |     |
  67.   |    date, if not today
  68.   |
  69.  time to execute
  70.  
  71.    The bottom of the screen shows these options:
  72.  
  73.     [s]uspend [r]esume  [t]ag [d]elete  [e]dit_crontab resca[n]  lo[g]_file 
  74.   <=prev page  (spacebar)  next page=>  [aA]dd  [qQ]uit  [p]urge_rexx_events
  75.  
  76.     suspend      - suspends CyberCron's (CC's) operation.
  77.     resume       - tells CC to resume operation.
  78.     tag          - tags events.  This is for (d)eleting several events
  79.                    at once.  A multi delete is kind of slow otherwise.
  80.     delete       - if any tagged events, delete them (with confirm),
  81.                    else delete the current event.
  82.     edit_crontab - pulls crontab into editor.
  83.     rescan       - gets events from CC again.  Some may have been
  84.                    executed since last redraw.
  85.     log_file     - toggles saving to CC's logfile ON/OFF.
  86.     <= space =>  - cursor left/right and space bar are used to move
  87.                    between windows if there is more than one.  Cursor
  88.                    up/down moves through events in a window.
  89.     add          - allows you to add an event, in the following format:
  90.                            hour:minute event
  91.                    *:* adds the event so that it will go off at the next
  92.                    minute.  It also appends an ":EXECONCE" so it only goes
  93.                    off once.  Return on a blank field to abort.
  94.     Add          - add an event using CC's format:
  95.                             min hr day mon dayofweek event
  96.     quit         - quit after confirming
  97.     Quit         - quick quit -- no confirm
  98.     purge        - removes all events that were added through CC's
  99.                    ARexx port
  100.  
  101.    The last line is some status items:
  102.  
  103.           Status:ACTIVE Crontab=SYS:S/CronTab Log=OFF
  104.  
  105.     Status       - CyberCron's status -- ACTIVE or SUSPENDED
  106.     Crontab      - the current path setting for the Crontab
  107.     Log          - whether logfile is ON or OFF
  108.  
  109.  
  110. III. User Settable Options
  111.      ---------------------
  112.  
  113.    They currently look something like this:
  114.  
  115.   /*---------------- USER SETTABLE OPTIONS (begin) ------------------------*/
  116.     screenwidth     = 640
  117.     screenheight    = 200
  118.     editor          = 'C:ed -sticky'
  119.     CyberCron       = 'ME:Tools/CyberCron'
  120.     crontab         = 'SYS:S/CronTab'
  121.     sendmail        = '"sendmail -f %s -R *"%s*""'
  122.     startcmd        = CyberCron 'CRONTAB' crontab 'SENDMAIL' sendmail
  123.     logfile         = 'LOGS:CyberCron.log'
  124.   /*---------------- USER SETTABLE OPTIONS (end) --------------------------*/
  125.  
  126.     editor      - your editor must stick to the CLI (for example CED's
  127.                   'ed -sticky').
  128.     CyberCron   - is the path and name of CyberCron on your system.
  129.     crontab     - path and name of your CronTab.
  130.     sendmail    - the uucp program that CC's :MAILUSER needs.  If you
  131.                   don't use the :MAILUSER option in any of your CC
  132.                   events, remove "'SENDMAIL' sendmail" from startcmd.
  133.     startcmd    - the dos command (including options) that you use to
  134.                   start CyberCron.
  135.     logfile     - path and name of CC's logfile.
  136.  
  137.  
  138. IV. Contact Info
  139.      ------------
  140.  
  141.    If you use this, please email me at:
  142.  
  143.    rick@emma.panam.wimsey.com (Rick Younie)
  144.    rick@freenet.vancouver.bc.ca (Rick Younie)
  145.